Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working with Movie Time

SetMovieTimeScale

The SetMovieTimeScale function establishes a movie's time scale.

pascal void SetMovieTimeScale (Movie theMovie, 
                                 TimeScale timeScale);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

timeScale

Specifies the movie's new time scale.

DESCRIPTION

In response to this request, the Movie Toolbox adjusts the edit list of the movie's tracks so that movie playback is unaffected. If you change a movie's time scale by setting it to a smaller value (thereby losing precision in the movie's time values), the Movie Toolbox may edit information from the movie. In general, you should only increase the time scale value, and you should try to use integer multiples of the existing time scale.

SPECIAL CONSIDERATIONS

Do not call SetMovieTimeScale if you have edited your movie. This function quantizes the beginning and the end of the edits to the new units. Therefore, if you do not use an integral multiple, the position of your edits may change.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can retrieve a movie's time scale by calling the GetMovieTimeScale function, which is described in the next section.